home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connection Student Program / ADC Tools Sampler CD Disk 3 1999.iso / Metrowerks CodeWarrior / Java Support / Java_Source / Java2 / src / javax / accessibility / AccessibleValue.java < prev   
Encoding:
Java Source  |  1999-05-28  |  2.6 KB  |  83 lines  |  [TEXT/CWIE]
  1. /*
  2.  * @(#)AccessibleValue.java    1.8 98/08/26
  3.  *
  4.  * Copyright 1997, 1998 by Sun Microsystems, Inc.,
  5.  * 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
  6.  * All rights reserved.
  7.  *
  8.  * This software is the confidential and proprietary information
  9.  * of Sun Microsystems, Inc. ("Confidential Information").  You
  10.  * shall not disclose such Confidential Information and shall use
  11.  * it only in accordance with the terms of the license agreement
  12.  * you entered into with Sun.
  13.  */
  14.  
  15. package javax.accessibility;
  16.  
  17. /**
  18.  * The AccessibleValue interface should be supported by any object 
  19.  * that supports a numerical value (e.g., a scroll bar).  This interface 
  20.  * provides the standard mechanism for an assistive technology to determine 
  21.  * and set the numerical value as well as get the minimum and maximum values.
  22.  * Applications can determine
  23.  * if an object supports the AccessibleValue interface by first
  24.  * obtaining its AccessibleContext (see
  25.  * {@link Accessible}) and then calling the
  26.  * {@link AccessibleContext#getAccessibleValue} method.
  27.  * If the return value is not null, the object supports this interface.
  28.  *
  29.  * @see Accessible
  30.  * @see Accessible#getAccessibleContext
  31.  * @see AccessibleContext
  32.  * @see AccessibleContext#getAccessibleValue
  33.  *
  34.  * @version     1.8 08/26/98 21:14:13
  35.  * @author    Peter Korn
  36.  * @author      Hans Muller
  37.  * @author      Willie Walker
  38.  */
  39. public interface AccessibleValue {
  40.  
  41.     /**
  42.      * Get the value of this object as a Number.  If the value has not been
  43.      * set, the return value will be null.
  44.      *
  45.      * @return value of the object
  46.      * @see #setCurrentAccessibleValue
  47.      */
  48.     public Number getCurrentAccessibleValue();
  49.  
  50.     /**
  51.      * Set the value of this object as a Number.
  52.      *
  53.      * @return True if the value was set; else False
  54.      * @see #getCurrentAccessibleValue
  55.      */
  56.     public boolean setCurrentAccessibleValue(Number n);
  57.  
  58. //    /**
  59. //     * Get the description of the value of this object.
  60. //     *
  61. //     * @return description of the value of the object
  62. //     */
  63. //    public String getAccessibleValueDescription();
  64.  
  65.     /**
  66.      * Get the minimum value of this object as a Number.
  67.      *
  68.      * @return Minimum value of the object; null if this object does not 
  69.      * have a minimum value
  70.      * @see #getMaximumAccessibleValue
  71.      */
  72.     public Number getMinimumAccessibleValue();
  73.  
  74.     /**
  75.      * Get the maximum value of this object as a Number.
  76.      *
  77.      * @return Maximum value of the object; null if this object does not 
  78.      * have a maximum value
  79.      * @see #getMinimumAccessibleValue
  80.      */
  81.     public Number getMaximumAccessibleValue();
  82. }
  83.